revCacheGeometry
Type
command
Summary
Updates Geometry settings.
Syntax
revCacheGeometry
Description
Use the revCacheGeometry command to update the Geometry pane's internal settings, after changing the size or position of controls that you have used the Geometry pane to specify behavior for.
The revCacheGeometry command rebuilds the Geometry pane's internal settings for the controls on the current card, storing the baseline position that the automatic positioning and scaling uses as a starting point.
The LiveCode development environment automatically executes the revCacheGeometry command when a resizeControl or moveControl message is sent. This means that when you move or resize a control in the development environment, its stored Geometry baseline is normally updated automatically.
Normally, you do not need to use the revCacheGeometry command at all, since LiveCode automatically updates the geometry settings when a control is moved or resized. However, if you move or resize controls manually or in a handler, and the resizeControl or moveControl message is not sent, you may need to use the revCacheGeometry command to update the baseline positions.
To update the settings, use the following statement in a handler or the message box, before changing cards or resizing the window:
revCacheGeometry
The revCacheGeometry command is part of the Geometry library. To ensure that the command works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "Geometry" library checkbox is checked.
Examples
revCacheGeometry
if the rect of me is not savedRect then revCacheGeometry
Related
message: moveControl, openBackground, startup, preOpenStack, openStack, resizeControl, preOpenCard
command: lock messages, revUpdateGeometry
glossary: LiveCode custom library, application, main stack, handler, development environment, Standalone Application Settings, message, group, standalone application, control, pane, command
library: Geometry library, library
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile